home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Mousetools / MouseAccelerator / Mausbeschleuniger.dok < prev    next >
Text File  |  1996-09-26  |  12KB  |  271 lines
  1.  
  2.                           Mausbeschleuniger
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. ---------------------------
  20. Mausbeschleuniger  ist  ein Commodity, das den Mauspfeil beschleunigt.
  21. Ein  Mausbeschleuniger ist zwar in AmigaOS 2.0 bereits eingebaut, wenn
  22. Ihnen  dieser  aber  zu  langsam  ist,  wird  Ihnen  dieses  Commodity
  23. gefallen.     Sie    können   eine   Beschleunigungsfaktor   und   ein
  24. Beschleinigungsminimum  (Pixel/Event)  einstellen.   Wenn Sie die Maus
  25. schneller  als  das  Beschleunigungsminimum  in  Pixel  pro Inputevent
  26. bewegen,   wird  sie  Bewegung  um  den  Faktor  Beschleunigungsfaktor
  27. beschleunigt.    Bewegen   Sie   die   Maus   langsamer,   wird  nicht
  28. beschleunigt, um besondere Aufgaben zu erleichtern. Die Beschleunigung
  29. von Intuition sollte mittels Input Preferences ausgeschaltet werden.
  30.  
  31. Systemanforderungen:
  32. --------------------
  33. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  34. 37.*, sowie die commodities.library ab Version 37.*.
  35. Bitte überprüfen Sie dies:
  36. Rufen  Sie  im  Menü  der  Workbench  unter  "Workbench" den Menüpunkt
  37. "About" auf. Sie bekommen eine Meldung folgender Art:
  38.  
  39.     Kickstart Version ww.xxx
  40.     Workbench Version yy.zzz
  41.  
  42. Wenn  Sie  dieses  Menü und den Menüpunkt nicht finden, dann haben Sie
  43. ein  Betriebssystem  vor  Version  2.0.  Unter diesen Versionen ist es
  44. nicht  möglich,  Mausbeschleuniger  zu  benutzen.   Bekommen  Sie eine
  45. Meldung  der  obigen Art, so vergewissern Sie sich bitte, daß dort für
  46. ww und yy 37 oder höher steht.
  47.  
  48. Und so startet man ein Commodity:
  49. ---------------------------------
  50. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  51. starten:  von der Workbench oder von der Shell aus.
  52.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  53. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  54. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  55. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  56. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  57. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  58. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  59. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  60. Commodity ändern können, wird später beschrieben.
  61.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  62. Commoditys,  während es bereits läuft, bewirkt, daß das Commodity sein
  63. Fenster  öffnet.   Da es nicht sinnvoll wäre Mausbeschleuniger zweimal
  64. zur gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.  Wenn
  65. Sie   die   Tool-Types   in   irgendeiner   Weise  verändern,  nachdem
  66. Mausbeschleuniger  gestartet  wurde,  wird ihm diese Veränderung nicht
  67. mitgeteilt.    Sie  müssen  ein  bereits  laufendes  Mausbeschleuniger
  68. verlassen und neu starten.
  69.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  70. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  71. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  72. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  73. Suchpfad.   Am  einfachsten  ist  es, das aktuelle Verzeichnis mit dem
  74. Befehl  "CD"  dorthin  zu ändern, wo das Commodity sich befindet.  Sie
  75. können  die Parameter eines Commodity mit Befehlsoptionen ändern.  Die
  76. verfügbaren  Optionen können Sie sich anzeigen lassen, indem Sie ein ?
  77. als ersten Parameter angeben:
  78.  
  79.                          Mausbeschleuniger ?
  80.  
  81. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  82. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  83. erreicht  man  wiederum, daß es sein Fenster öffnet.  Dabei wird keine
  84. der angegebenen Befehlsoptionen berücksichtigt.
  85.  
  86.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  87. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  88. einfügen:
  89.  
  90.                   <Pfad>Mausbeschleuniger <Optionen>
  91.  
  92. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  93. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  94. anzugeben.  Folgendes Beispiel startet Mausbeschleuniger, wenn es sich
  95. im  Schubladen  Tools  der  Boot-Diskette  befindet,  so  daß  der der
  96. Mauspfeil um den Faktor 5 beschleunigt wird:
  97.  
  98.                    Tools/Mausbeschleuniger FAKTOR=5
  99.  
  100.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  101. starten,  ist,  das  Icon  von  Mausbeschleuniger  in  den  Schubladen
  102. WBStartup der Boot-Diskette (Workbench) zu verschieben.  Das Commodity
  103. wird  dann  bei  jedem  Boot-Vorgang  gestartet,  als hätten Sie einen
  104. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  105. das Tool-Type DONOTWAIT ergänzen.
  106.  
  107. Benutzung von Exchange:
  108. -----------------------
  109. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  110. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  111. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  112. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  113. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  114. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  115. Titel, Beschreibung und Status angezeigt.
  116.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  117. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  118. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  119. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  120. "Show" öffnen lassen und mit "Hide" schließen lassen.
  121.  
  122.  
  123.                        Veränderbare Parameter:
  124.                        -----------------------
  125.  
  126. CX_Priority:
  127. ------------
  128. Mit dem Tool-Type oder der Befehlsoption CX_PRIORITY=<Zahl> können Sie
  129. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  130. bestimmen.  Setzen Sie für <Zahl> bitte einen dezimalen Wert ein.  Die
  131. voreingestellte Priorität ist 0.
  132.  
  133. FAKTOR:
  134. -------
  135. Mit der Befehlsoption bzw.  dem Tool-Type FAKTOR=<Zahl> können Sie den
  136. Beschleunigungsfaktor einstellen.
  137.     Wenn  Sie Mausbeschleuniger bereits gestartet haben, so können Sie
  138. den  Faktor  auch  in  einem  Fenster einstellen, das Sie mit Exchange
  139. öffnen  können.   Starten  Sie  Exchange, wählen Sie aus der Liste der
  140. Commodities  Mausbeschleuniger,  und  drücken Sie den Schalter "Show".
  141. Jetzt  hat  sich  das  Fenster  von  Mausbeschleuniger geöffnet.  Hier
  142. können  Sie  den  Beschleunigungsfaktor und das Beschleunigungsminimum
  143. einstellen,  das  Fenster  wieder verschwinden lassen mit "Verstecken"
  144. oder den Mausbeschleuniger beenden mit "Beenden".
  145.  
  146. MINIMUM:
  147. --------
  148. Mit  der  Befehlsoption  bzw.  dem Tool-Type MINIMUM=<Zahl> können Sie
  149. das Minimum in Pixel pro Inputevent einstellen, um das die Maus bewegt
  150. werden  muß,  damit eine Beschleunigung eintritt.  Diese Option können
  151. Sie auch im Fenster von Mausbeschleuniger ändern.
  152.  
  153. CX_Popkey:
  154. ----------
  155. Mit  CX_Popkey=<Zeichenkette> können Sie ein Tastaturkürzel bestimmen,
  156. mit  dem  Sie  das Fenster von Mausbeschleuniger öffnen können.  Bitte
  157. ersetzen  Sie  <Taste>  durch  eine Eingabebeschreibung, wie sie unten
  158. erklärt   wird.    Wenn   Sie   diese   Option  weglassen,  wird  kein
  159. Tastaturkürzel installiert. Voreingestellt ist kein Kürzel.
  160.  
  161. Beispiele:
  162.  
  163.     CX_POPKEY=f1                (F1 öffnet das Fenster)
  164.     "CX_POPKEY=lshift f1"       (linke Shift-Taste und F1)
  165.     "CX_POPKEY=alt m"           (eine Alt-Taste und die Taste M)
  166.  
  167. CX_Popup:
  168. ---------
  169. Mit   CX_POPUP=JA|NEIN   können  Sie  bestimmen,  ob  beim  Start  von
  170. Mausbeschleuniger dessen Fenster geöffnet werden soll.  JA|NEIN heißt,
  171. Sie  können  entweder  JA  oder  NEIN  einsetzen, aber nichts anderes.
  172. Voreingestellt ist NEIN.
  173.  
  174.  
  175.                         Eingabebeschreibungen
  176.                         ---------------------
  177.                      (input description strings)
  178.  
  179. Mit   Eingabebeschreibungen  können  Sie  jede  Tastenkombination  der
  180. Tastatur  und  der  Maus  beschreiben, z.B.  das Drücken der Taste F1,
  181. Shift-F1  oder  Alt-F1  oder das Drücken der linken Maustaste zusammen
  182. mit Alt etc.  Darueberhinaus sind einige andere Ereignisse abfragbar.
  183.  
  184. Eingabebeschreibungen haben folgendes Muster:
  185.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  186.  
  187. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  188.  
  189. class   ("Klasse") ist einer der folgenden Ausdrücke:
  190.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  191.         diskremoved, diskinserted.
  192.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  193.  
  194. qual    ("Qualifizierer") ist einer der folgenden Ausdrücke:
  195.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  196.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  197.         relativemouse
  198.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  199.         als irrelevant angenommen werden soll.
  200.  
  201. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  202.         shift bedeutet linke oder rechte Shift-Taste
  203.         caps bedeutet Shift oder Caps-Lock
  204.         alt bedeutet linke oder rechte Alt-Taste
  205.  
  206. upstroke (wörtlich "upstroke")
  207.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  208.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  209.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  210.         voran, so zählt beides.
  211.  
  212. highmap ist einer der folgenden Ausdrücke:
  213.         comma, space, backspace, tab, enter, return, esc, del, up,
  214.         down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9,
  215.         f10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  216.  
  217. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  218.         Taste
  219.  
  220.  
  221. Noch einige Beispiele:
  222. ----------------------
  223.  
  224.     Mausbeschleuniger faktor=10
  225.     Mausbeschleuniger Faktor=5 "cx_popkey=ctrl 1" cx_popup=ja
  226.     Mausbeschleuniger Faktor=3 Minimum=4 "cx_popkey=help"
  227.  
  228.  
  229. Besonderen Dank
  230. ---------------
  231. an Matt Dillon für den Code zur Mausbeschleunigung (aus DMouse).
  232.  
  233.  
  234. Versionengeschichte:
  235. --------------------
  236. V1.06   kleiner Fehler wurde behoben
  237. V1.05   Requester werden nun auf dem selben Screen wie das Fenster
  238.         geöffnet. Durch etwas Optimierung wurde das Programm kürzer.
  239. V1.04   Fenster wird nun auf dem vordersten Screen geöffnet, sofern
  240.         dieser öffentlich ist. Ist er dies nicht, wird das Fenster wie
  241.         gehabt auf dem default public screen geöffnet;
  242.         Enforcer-Hit bei Speichermangel wurde entfernt
  243. V1.03   Minimum der Pixel pro Event wurde auf 20 geändet, da ein höhe-
  244.         rer Wert nicht sinnvoll ist und somit das Fenster schöner ge-
  245.         staltet werden kann. Wird der Beschleunigungsfaktor auf 1 ge-
  246.         setzt, so werden nun keine Mausbewegungen mehr ausgewertet.
  247.         Damit spart man etwas CPU-Zeit.
  248. V1.02   SAS/Cs cback.o wurde für 68040-Kompatibilität von mir nach
  249.         Instruktionen von Michael Sinz geändert; Mausbeschleuniger
  250.         wurde mit diesem cback.o neu gebunden
  251.  
  252.  
  253. Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und 
  254. -----------------------------------------------------------
  255. Geschenke an:
  256. -------------
  257.  
  258. Stefan Sticht
  259. Bibereckerweg 40a
  260. D-8390 Passau 18
  261. FRG
  262.  
  263. oder (besser) an eine der folgenden EMail-Adressen:
  264. sticht@edith.deg.sub.org
  265. Fido-Netz: Stefan Sticht (2:246/200.4)
  266.  
  267. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  268. Diese erhalten Sie z.B. mit dem Befehl "Version":
  269.                      Version [<path>]<commodity>
  270.  
  271.